home *** CD-ROM | disk | FTP | other *** search
/ FishMarket 1.0 / FishMarket v1.0.iso / fishies / 301-325 / disk_319 / cnewssrc / cnews.orig.lzh / man / rnews.man < prev    next >
Text File  |  1989-06-28  |  6KB  |  133 lines
  1.  
  2.  
  3.  
  4.      RRRRNNNNEEEEWWWWSSSS((((8888))))              CCCC NNNNeeeewwwwssss ((((22224444 MMMMaaaayyyy 1111999988889999))))               RRRRNNNNEEEEWWWWSSSS((((8888))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           rnews, cunbatch - accept and spool news input
  10.           recbnews, recpnews, bdecode - accept and spool news received
  11.           via mail
  12.           newsspool, newsrun, c7decode - news input spooler and
  13.           processing
  14.           newsrunning - control news-processing daemon
  15.  
  16.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  17.           rrrrnnnneeeewwwwssss [ file ... ]
  18.           ccccuuuunnnnbbbbaaaattttcccchhhh [ file ... ]
  19.           ////uuuussssrrrr////lllliiiibbbb////nnnneeeewwwwssssbbbbiiiinnnn////iiiinnnnppppuuuutttt////rrrreeeeccccbbbbnnnneeeewwwwssss
  20.           ////uuuussssrrrr////lllliiiibbbb////nnnneeeewwwwssssbbbbiiiinnnn////iiiinnnnppppuuuutttt////rrrreeeeccccppppnnnneeeewwwwssss
  21.           ////uuuussssrrrr////lllliiiibbbb////nnnneeeewwwwssssbbbbiiiinnnn////iiiinnnnppppuuuutttt////nnnneeeewwwwssssssssppppoooooooollll [ ----iiii ] [ file ... ]
  22.           ////uuuussssrrrr////lllliiiibbbb////nnnneeeewwwwssssbbbbiiiinnnn////iiiinnnnppppuuuutttt////nnnneeeewwwwssssrrrruuuunnnn
  23.           ////uuuussssrrrr////lllliiiibbbb////nnnneeeewwwwssssbbbbiiiinnnn////iiiinnnnppppuuuutttt////cccc7777ddddeeeeccccooooddddeeee
  24.           ////uuuussssrrrr////lllliiiibbbb////nnnneeeewwwwssssbbbbiiiinnnn////iiiinnnnppppuuuutttt////bbbbddddeeeeccccooooddddeeee [ file ]
  25.           ////uuuussssrrrr////lllliiiibbbb////nnnneeeewwwwssssbbbbiiiinnnn////iiiinnnnppppuuuutttt////nnnneeeewwwwssssrrrruuuunnnnnnnniiiinnnngggg {oooonnnn|ooooffffffff}
  26.  
  27.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  28.           _R_n_e_w_s accepts the named _f_i_l_e(s) (standard input default) as
  29.           news, and spools it up for processing, space permitting.
  30.           _C_u_n_b_a_t_c_h is a historical synonym for _r_n_e_w_s; there is no
  31.           difference in what they do.
  32.  
  33.           _R_e_c_b_n_e_w_s receives news sent as mail in _b_e_n_c_o_d_e format (see
  34.           _n_e_w_s_b_a_t_c_h(8)), runs it through _b_d_e_c_o_d_e, and feeds it to
  35.           _r_n_e_w_s.  _R_e_c_p_n_e_w_s does likewise for news sent as mail with
  36.           `N' prepended to each line.
  37.  
  38.           _N_e_w_s_s_p_o_o_l is the actual spooling program.  It creates a
  39.           spool file with a name based on the current time (which
  40.           avoids the need for locking) in the spooling directory
  41.           /_u_s_r/_s_p_o_o_l/_n_e_w_s/_i_n._c_o_m_i_n_g and copies the input _f_i_l_e(s)
  42.           (standard input default) to it, stripping off any
  43.           `####!!!! ccccuuuunnnnbbbbaaaattttcccchhhh' or `####!!!! cccc7777uuuunnnnbbbbaaaattttcccchhhh' header as it does so.  If
  44.           invoked with the ----iiii option, when finished it attempts to
  45.           start _n_e_w_s_r_u_n to process the new news immediately.
  46.  
  47.           _N_e_w_s_r_u_n should be run periodically (e.g. by _c_r_o_n(8)) to
  48.           process spooled news.  _N_e_w_s_r_u_n_n_i_n_g can be used to enable and
  49.           disable _n_e_w_s_r_u_n's processing if it is desired to avoid major
  50.           news processing during certain hours.
  51.  
  52.           _N_e_w_s_r_u_n checks for the _s_t_o_p file that _n_e_w_s_r_u_n_n_i_n_g _o_f_f
  53.           creates, verifies that there is enough disk space for
  54.           processing, and then starts processing spooled news.  Each
  55.           batch is run through _c_7_d_e_c_o_d_e (if necessary), de_c_o_m_p_r_e_s_sed
  56.           (if necessary), and then fed to _r_e_l_a_y_n_e_w_s (on the server, if
  57.           /_u_s_r/_l_i_b/_n_e_w_s/_s_e_r_v_e_r exists and contains its name).  If
  58.           _r_e_l_a_y_n_e_w_s fails, _n_e_w_s_r_u_n reports this (by mail to uuuusssseeeennnneeeetttt)
  59.           and attempts to save the spooled batch in the _b_a_d
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 6/29/89)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      RRRRNNNNEEEEWWWWSSSS((((8888))))              CCCC NNNNeeeewwwwssss ((((22224444 MMMMaaaayyyy 1111999988889999))))               RRRRNNNNEEEEWWWWSSSS((((8888))))
  71.  
  72.  
  73.  
  74.           subdirectory for human inspection.  To bound the
  75.           accumulation in _b_a_d in the event of some systematic problem,
  76.           _n_e_w_s_r_u_n limits _b_a_d to 50 files; this default can be changed
  77.           by placing a _l_i_m_i_t file in _b_a_d, containing one ASCII line
  78.           with the desired numeric limit.  A limit of 0 will prevent
  79.           saving of bad batches.
  80.  
  81.           _C_7_d_e_c_o_d_e passes standard input to standard output, decoding
  82.           a complex and bizarre encoding of 8-bit data as printable
  83.           ASCII characters.  _B_d_e_c_o_d_e passes standard input, or the
  84.           _f_i_l_e if there is one, to standard output, decoding the
  85.           _b_e_n_c_o_d_e encoding and stripping off debris prepended and
  86.           appended by mailers.
  87.  
  88.      FFFFIIIILLLLEEEESSSS
  89.           (All in /_u_s_r/_s_p_o_o_l/_n_e_w_s/_i_n._c_o_m_i_n_g)
  90.  
  91.           000000000 (etc.) spooled news
  92.           stop      _n_e_w_s_r_u_n disable file
  93.           bad       directory for failed news
  94.           bad/limit limit on number of files in _b_a_d
  95.  
  96.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  97.           compress(1), newsbatch(8), relaynews(8)
  98.  
  99.      DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  100.           Complaints are mailed to uuuusssseeeennnneeeetttt if something goes wrong.
  101.  
  102.      HHHHIIIISSSSTTTTOOOORRRRYYYY
  103.           Part of C News.  Written at University of Toronto by Henry
  104.           Spencer.
  105.  
  106.      BBBBUUUUGGGGSSSS
  107.           _C_7_d_e_c_o_d_e should be part of the underlying transport
  108.           mechanism.  It hasn't been tested very well in the C News
  109.           environment.  _B_e_n_c_o_d_e is probably better.
  110.  
  111.           _R_e_c_p_n_e_w_s and the protocol it uses are obsolescent, as
  112.           _r_e_c_b_n_e_w_s and _b_d_e_c_o_d_e are far superior.
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 6/29/89)
  130.  
  131.  
  132.  
  133.